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EXECUTIVE REQUEST INSTRUCTIONS UNDER OS-3 



Code 



Request Action and Error Conditions 

DELETE Delete file name (in AQ) from file 

directory. File must be equipped as 
the specified logical unit. 



ERROR 

1 
2 
3 
4 



unit is not equipped 

file is protected 

unit is not a saved file 

name in AQ does not agree with 

name of file 
not enough scratch file space 

for file 



SAVE 



Save specified logical unit under name 
in AQ (put name in file directory) . 



ERROR 

1 
2 



unit is not equipped 

there already exists a file with 

the name given in AQ 
unit is already a saved file 
unit is not a file 
not enough saved file space 

for file 
name is illegal (such as FILE, 

PUN, etc.) 



UNEQUIP Unequip the specified logical unit. 
AQ is ignored. 



ERROR 

1 
2 



unit is not equipped 
unit is a file which is pro- 
tected and not saved 



EQUIP 



If A 7^ 0, equip specified unit as the 
saved file whose name is in AQ or as 
the hardware unit whose name is in AQ. 
See list below. If A = 0, equip 
specified unit as equivalent to the 
unit number specified is in Q(0 to 100). 



If no error occurs, A contains the status 
of the unit after equipping it. 

HARDWARE NAMES (in AQ) : 

FILE create an empty scratch file 

LP line printer 

PR same as LP 

PUN card punch 

PLOT plotter 

RAF create an empty random access 
file 

TASK remote batch job 

NULL null (device absorbs and dis- 
cards all outputs to it) 

MT (in A) magnetic tape 

no. (in Q) reel number in Q 

ERROR 

1 unit is already equipped 

2 there is no saved file with the 

name given in AQ (or, perhaps , 
file is busy) 

3 unit number (in Q) is not equipped 

4 saved file with name in AQ is 

busy (it is not protected 
and some other user has it 
equipped) 

5 not enough tape drives available 

6 illegal tape number or density 

7 not enough hardware available 

RFP Remove file protection from specified 

unit. If it is saved, its name must be 
given in AQ. If it is not save, AQ is 
ignored. 

ERROR 

1 unit is not equipped 

2 file is busy (some other user 

is equipped to it, too) 

3 name in AQ does not agree with 

the name of the file 

4 file is public (first character 

of name is an asterisk) and 
it belongs to some other 
user 

FP Protect the file which is equipped to 

the specified unit. AQ is ignored. 



ERROR 



1 unit is not equipped 

2 unit is not a file 



unused 
ZEROPAGE 



Effective address (0 to 37g) specifies 
a page in memory, which is set to all 
zero. A page is 2048 words, and they 
are numbered from the low end of memory 
upward. Thus, page extends from 
address 000000 to 003777, page 13 extends 
from 054000 to 057777, etc. AQ is 
ignored . 
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LIBCALL Call the library program whose name is 
in AQ. This involves copying the pro- 
gram into the pages of memory which 
it is to occupy and transferring 
control to it. If the library program 
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have been defined previously by storing 
ASCII characters , using the ACI instruc- 
tion. The effective address is ignored 

ERROR 

If there is no library program by the 
name given in AQ, nothing is done and 
the computer executes the next instruc- 
tion after the XREQ. 
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TIME SET This will set the upper limit on usable 
CPU time before a "TIME CUT" will result, 
The time, in seconds, should be placed 
in the A Register. 
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TIME REQ This will return, in the A Register, 
CPU time (in milliseconds) used since 
logging on. The Q Register will 
contain the maximum available CPU 
time (in seconds) at login. 

MFBLK SET This will set the upper MFBLK limit. 

The request limit in file blocks should 
be put in the A Register. 



14 



MFBLK REQ This will return with the maximum file 
blocks used in the A Register and the 
current file blocks used in the Q 
Register. 
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SFBLK REQ Returns with the current number of 
saved file blocks in the A Register 
and the saved file block limit in the 
Q Register. 
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PURGE 



SET MEM 
PROTECT 



This will remove all existing characters 
from the parameter string. 

This will enable the memory protect 
violation message if the low order 
bit in the address field of the XREQ 
is set. The message will be disabled 
if the bit is not set. 

A memory protect violation occurs when 

pure page. 

The message is disabled after the 
user has been informed. 
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ASSIGN 



This will send a line printer (LUN 
in the address field of the XREQ) to 
a particular output device. The 
device number is specified in the A 
Register. 



ERROR 

1 
2 



LUN is not equipped 

LUN is not a unit record device 
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PAGE SIZE This will return, in the A Register, 
the number of print lines per page on 
the system standard line printer. 
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FILE SIZE This will return the file length 

(in blocks) in the A Register for the 
LUN specified by the address field of 
the XREQ. The Q Register contains 
the following information for each 
specified device listed: 



Device Type Q Register 

Regular Files and RAFS Garbage 

Unit Record Equipment Record Count 
(LP, PUN, etc.) .—- - :::;^_____^^ 

Magnetic Tape f' Tape Device J 

V .Number ... 

MSF Number of 

Seconds On- 
Line 

26 DELAY REQ This will suspend the running of a 

user program for the time (in seconds) 
specified by the lower six bits of the 
A Register. 

This XREQ is effective only from on- 
line terminals . 

Any attempt at "INPUT" will terminate 
the suspension. "INPUT" includes any 
teletype character, or "Send" from a 
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the number of seconds left in the delay 
quantum. 

ERROR 

6 user was a batch terminal 

27 CFBLK REQ This will return the current number 

of file blocks used in the Q Register 
and the maximum number of usable file 
blocks in the A Register. 



